home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / mpage113.zip / MPAGE.DOC < prev    next >
Text File  |  1991-08-19  |  10KB  |  236 lines
  1.  
  2.  NAME
  3.      mpage - print Multiple PAGEs per sheet on a POSTSCRIPT printer
  4.  
  5.  SYNOPSIS
  6.      mpage [-abcdfisuv] [-e fontname] [-g o|e ] [-h header]
  7.            [-l lines] [-m margin] [-n number] [-o orientation] 
  8.            [-p pages] [-r file] [-t tabs] [-w width] files...
  9.  
  10.  DESCRIPTION
  11.      MPAGE reads one or more plain ASCII text files and prints them on a
  12.      POSTSCRIPT printer with the text reduced in size so that 1, 2, or 4
  13.      pages are fitted on one sheet of paper. (Up to 8 pages on one sheet
  14.      when printing on both sides).
  15.  
  16.      It is also possible to set your default MPAGE options in the
  17.      environment variable MPAGE.  If this variable exist, its options
  18.      will be scanned in and placed in front of parameters given on
  19.      the command-line.  This makes it possible to override default
  20.      configuration.
  21.  
  22.      The following options are recognized:
  23.  
  24.      -a   When printing 4 pages on the same sheet, one has to decide
  25.           where to place succesively numbered pages.  This option will
  26.           place page N in the upper left quadrant, page N+1 in the upper
  27.           right quadrant, page N+2 in the lower left quadrant, and page
  28.           N+3 in the lower right quadrant.  This is also the default way
  29.           of layout.
  30.  
  31.      -b   MPAGE will separate the individual pages on a sheet by drawing
  32.           a border round each page.  Use this option if you do not want
  33.           this border to be printed.
  34.  
  35.      -c   The default action when a line exceeds the right margin is to
  36.           continue on the next line.  If you instead want to clip the line
  37.           then use this option.
  38.  
  39.      -d   When printing 4 pages on the same sheet, one has to decide
  40.           where to place succesively numbered pages.  This option will
  41.           place page N in the upper left quadrant, page N+1 in the lower
  42.           left quadrant, page N+2 in the upper right quadrant, and page
  43.           N+3 in the lower right quadrant.
  44.  
  45.      -f   Each file printed by MPAGE will be preceeded by a frontpage to
  46.           specify which file that follows.  This is mainly to ease the
  47.           separation of several files printed in the same batch.  It's
  48.           also a great way of spending paper, so feel free to turn it
  49.           off with this option.
  50.  
  51.      -i   Many DOC-files contains <FF>-codes to split pages at the right
  52.           place.  This option will force MPAGE to take no notice of such
  53.           codes.
  54.  
  55.      -s   By default, MPAGE will reserve the last 3 lines of a page to
  56.           print the name of the file and the pagenumber.  By using this
  57.           option this can be turned off, and you gain 3 lines per page.
  58.  
  59.      -u   Use this when using US papersize and not A4 which is default.
  60.  
  61.      -v   Unless an error occurs, MPAGE will normally not give any hint
  62.           at what it is doing at the moment.  When used with this verbose
  63.           option, MPAGE will print the number of each sheet it has
  64.           finished processing.
  65.  
  66.      -e fontname
  67.           Allow user-selected font to be used instead of the default
  68.           Courier.  Please note that no verification is made before
  69.           using this font so take care.
  70.  
  71.      -g o|e
  72.           I'm running out of letters, so I call this the Grumpf-option.
  73.           What it does is simply giving you a option of printing only
  74.           odd or even numbered pages.  This is useful if you want to
  75.           use both sides of the paper; then simply use -g o to print
  76.           page 1,3,5,7... - reload the paper and use -g e to print the
  77.           other pages.  Because of the complexity of this option, it
  78.           might be wise of you to experiment a little before starting
  79.           a _major_ printjob with several files and prefaces.
  80.  
  81.      -h header
  82.           Sometimes it can be useful to print a header on top of each
  83.           page.  This option let you do exactely that - at the cost of
  84.           loosing 2 lines of print per page.  Please note that the text
  85.           given as header-text must be encapsuled by "" if it contains
  86.           more than one word.
  87.  
  88.      -l lines
  89.           The default number of lines per page is set to 52 for the
  90.           landscape orientation, and 66 for the normal (or portrait)
  91.           orientation.  By specifying another number of lines the
  92.           text fill be scaled to accommodate such a choice.  Note that
  93.           this number is reduced by 2 when using headers and by 3 when
  94.           using stamp.  So when using both these options, specifying 66
  95.           lines really means you get 61 printable lines.
  96.  
  97.      -m margin
  98.           If you plan to bind the sheets produced by MPAGE together,
  99.           you may find the margins a bit to narrow.  This option will
  100.           let you specify a new value for the margin.  The default
  101.           value is 20, and 40 should be suitable for binding.
  102.  
  103.      -n number
  104.           When printing code-listings, I sometimes find linenumbers
  105.           for each N'th line usefull.  So, to suit myself I included
  106.           this as an option in MPAGE.  When used, the pagewidth will
  107.           be enlarged enough to make room for linenumbers at the end
  108.           of the textline.  Numbers specify the value of N.  Please
  109.           observe that this option will also invoke the -i option.
  110.  
  111.      -o orientation
  112.           The default orientation of the sheet is to use landscape
  113.           when printing 2 pages per sheet, and normal (or portrait)
  114.           when printing 1 or 4 pages per sheet.  To override this
  115.           default orientation, use the -o option followed by a l for
  116.           landscape and a n for normal orientation.
  117.  
  118.      -p pages
  119.           MPAGE lets you print 1, 2 or 4 pages per sheet.  The
  120.           default is 4, but with this option you may specify any
  121.           of the available choices.
  122.  
  123.      -r file
  124.           Not everyone is fortunate enough to have a Postscript
  125.           printer on their desk.  By using this option MPAGE let
  126.           you temporarely store the output on a file for later
  127.           dumping it to the printer.  If not used, MPAGE will
  128.           assume you mean to write directly to PRN:
  129.  
  130.      -t n
  131.           By default MPAGE assumes a tab is equal to 8 spaces,
  132.           which seems to be the most used value for text-documents.
  133.           If you prefer another value, use this option.
  134.  
  135.      -w width
  136.           The default number of columns per page is set to 132 for
  137.           the landscape orientation, and 80 for the normal (portrait)
  138.           orientation.  By specifying another number of columns the
  139.           text fill be scaled to accommodate such a choice.
  140.  
  141.      files...
  142.           All other commandline arguments will be taken as filenames
  143.           of files to print.  Wildcards are now supported.
  144.  
  145.  
  146.  VERSIONS
  147.      Version 1.00, Not released
  148.         - initial version, only 4 pages per sheet in portrait
  149.  
  150.      Version 1.01, Not released
  151.         - added support for 1 and 2 pages per sheet
  152.         - added support for landscape orientation
  153.         - added support for frontpage
  154.         - added support for stamp (filename/page)
  155.         - added support for ignoring <FF> codes
  156.         - added support for headertext
  157.         - added support for marginsettings
  158.         - added support for norwegian characters
  159.         - fixed bug regarding pagelenght and pagewidth
  160.         - fixed bug regarding '(', ')', and '\'
  161.         - fixed bug regarding bad clipregion
  162.         - changed default values to more 'obvious' values
  163.  
  164.      Version 1.02, Not released
  165.         - added support for linenumbering
  166.  
  167.      Version 1.03, Not released
  168.         - fixed bug regarding linenumbering
  169.         - optimized code
  170.  
  171.      Version 1.04, Not released
  172.         - OS/2 support, MPAGE now works for MS-DOS and OS/2
  173.  
  174.      Version 1.05, Relased March 1991
  175.         - added support for clipping of lines exceeding rightmargin
  176.         - added support for US papersizes
  177.  
  178.      Version 1.05e, Released March 1991
  179.         - added support for selecting font
  180.  
  181.      Version 1.06, Not released
  182.         - added support for environment-variab